IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/u_man/cat1/dprof.z/dprof

Text File | 2002-10-03 | 7.3 KB | 199 lines

DDDDPPPPRRRROOOOFFFF((((1111))))                                                              DDDDPPPPRRRROOOOFFFF((((1111))))



NNNNAAAAMMMMEEEE
     ddddpppprrrrooooffff - a memory access profiling tool

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     dprof [----iiiittttiiiimmmmeeeerrrr [----mmmmssss nnnn]]
     [----hhhhwwwwppppcccc [----ccccnnnnttttrrrr  _n] [----oooovvvvffffllll _n]]
     [----ppppccccmmmmiiiinnnn _m_i_n] [----ppppccccmmmmaaaaxxxx _m_a_x]
     [----ddddaaaammmmiiiinnnn mmmmiiiinnnn] [----ddddaaaammmmaaaaxxxx mmmmaaaaxxxx]
     [----ppppaaaaggggeeee|----lllliiiinnnneeee|----hhhheeeexxxx|----oooocccctttt|----qqqquuuuaaaadddd|----ddddoooouuuubbbblllleeee|----iiiinnnntttt|----wwwwoooorrrrdddd]
     [----ssssiiiigggguuuussssrrrr]
     [----oooouuuutttt _f_i_l_e] [----ppppoooouuuutttt _d_p_l_a_c_e__f_i_l_e] [----tttthhhhrrrreeeeaaaaddddssss____ppppeeeerrrr____mmmmeeeemmmm _n]
     [----vvvveeeerrrrbbbboooosssseeee] _c_o_m_m_a_n_d


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The given _c_o_m_m_a_n_d is executed and memory accesses are sampled; after
     completion, _d_p_r_o_f prepares a histogram of memory accesses.  Histograms
     are computed for each thread of multi-threaded applications that utilize
     sssspppprrrroooocccc(2).




OOOOPPPPTTTTIIIIOOOONNNNSSSS
     ----iiiittttiiiimmmmeeeerrrr
          Use the interval timer as a sampling trigger.  This is the default
          sampling method on all systems other than Origin and
          PowerChallenge/PowerOnyx R10000 systems.

     ----mmmmssss _n
          Trigger every _n milliseconds. The default is 10 milliseconds, this
          is also the minimum value. Any value of _n less than 10 will result
          in an error.

     ----hhhhwwwwppppcccc
          Use R10000 hardware event counter overflow as a sampling trigger.
          This is the default sampling method for all Origin systems, and
          PowerChallenge/PowerOnyx R10000 systems. This option is not
          available on other systems.

     ----ccccnnnnttttrrrr _n
          Use R10000 hardware event counter _n as the event trigger.  Default
          is number of cycles; event 0.

     ----oooovvvvffffllll _n
          Trigger after _n events have occurred.  Default is 10,000.

     ----ppppccccmmmmiiiinnnn _m_i_n
          Ignore events that have a program counter smaller than _m_i_n.






                                                                        PPPPaaaaggggeeee 1111






DDDDPPPPRRRROOOOFFFF((((1111))))                                                              DDDDPPPPRRRROOOOFFFF((((1111))))



     ----ppppccccmmmmaaaaxxxx _m_a_x
          Ignore events that have a program counter larger than _m_a_x.

     ----ddddaaaammmmiiiinnnn _m_i_n
          Ignore memory operations that have a virtual addresses smaller than
          _m_i_n.

     ----ddddaaaammmmaaaaxxxx _m_a_x
          Ignore memory operations that have a virtual addresses larger than
          _m_a_x.

     ----ppppaaaaggggeeee
          Use pagesize (16k bytes) granularity for memory access sampling.
          This is the default size.

     ----lllliiiinnnneeee
          Use cache linesize (128 bytes) size granularity for memory access
          sampling.

     ----hhhheeeexxxx Use hex (64 bytes) size granularity for memory access sampling.

     ----oooocccctttt Use oct (32 bytes) size granularity for memory access sampling.

     ----qqqquuuuaaaadddd
          Use quad (16 bytes) size granularity for memory access sampling.

     ----ddddoooouuuubbbblllleeee
          Use double (8 bytes) size granularity for memory access sampling.

     ----iiiinnnntttt Use int (4 bytes) size granularity for memory access sampling.

     ----wwwwoooorrrrdddd
          Use int (4 bytes) size granularity for memory access sampling.

     ----ssssiiiigggguuuussssrrrr
          Sampling is not started until SIGUSR1 is received. Further SIGUSR1
          signals toggle sampling off and on.

     ----oooouuuutttt _f_i_l_e
          Output is sent to _f_i_l_e rather than standard output.

     ----ppppoooouuuutttt _d_p_l_a_c_e__f_i_l_e
          Placement information suitable for ddddppppllllaaaacccceeee(1) is written to
          _d_p_l_a_c_e__f_i_l_e.

     ----tttthhhhrrrreeeeaaaaddddssss____ppppeeeerrrr____mmmmeeeemmmm _n
          When building _d_p_l_a_c_e__f_i_l_e a thread assignment that assumes _n threads
          per memory is assumed. The default is two threads per memory.

     ----vvvveeeerrrrbbbboooosssseeee
          Detailed diagnostic information is written to standard error.




                                                                        PPPPaaaaggggeeee 2222






DDDDPPPPRRRROOOOFFFF((((1111))))                                                              DDDDPPPPRRRROOOOFFFF((((1111))))



EEEEXXXXAAAAMMMMPPPPLLLLEEEE
     To collect a memory access histogram from a program called a.out that
     would normally be run by
        % a.out < in > out
     and place the results in a file called _h_i_s_t_o_g_r_a_m one would simply
        % dprof -out histogram a.out < in > out .


DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
     ddddpppprrrrooooffff options ----hhhhwwwwppppcccc, ----ccccnnnnttttrrrr _n and ----oooovvvvffffllll _n only apply to R10000 based
     systems.


NNNNOOOOTTTTEEEESSSS
     ddddpppprrrrooooffff option ----ppppoooouuuutttt will generate a simple placement file based on the
     count of page references per the sampling criteria. This is a basic
     placement file which cannot take into consideration such factors as
     temporal access, node distance, and absolute page reference counts, and
     large pages.


SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ddddppppllllaaaacccceeee(1), sssspppprrrroooocccc(2), rrrr11110000kkkk____ccccoooouuuunnnntttteeeerrrrssss(5)
































                                                                        PPPPaaaaggggeeee 3333